home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / battle14.zip / BATTLE.DOC next >
Text File  |  1993-02-22  |  14KB  |  306 lines
  1.          ┌▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄┐
  2.          ├▌▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▐┤
  3.  ────────┤▌ G  A  M  E  K  E  E  P  E  R    D  O  O  R  W  A  R  E ▐├────────
  4.          ├▌▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▐┤
  5.          ├▌▒▒▒▒▒▒▒▒▒  Quality BBS Door Software for Less!  ▒▒▒▒▒▒▒▒▐┤
  6.          ├▌▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▐┤
  7.          └▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀┘
  8.  
  9.                             B A T T L E F I E L D
  10.                             ~~~~~~~~~~~~~~~~~~~~~
  11.                                  Version 1.4
  12.  
  13.                      Copyright (c) Steve Sharpe 1992,1993
  14.  
  15. SYSTEM REQUIREMENTS
  16. ~~~~~~~~~~~~~~~~~~~
  17. Any BBS capable of producing the following DOOR.SYS drop files:
  18.  
  19.    *  Original "GAP standard" DOOR.SYS (31 line version)
  20.         - for example, Spitfire BBSs use this one!
  21.  
  22.    *  New (currently 52 line) version DOOR.SYS promoted by Raymond Clements
  23.         - for example, PCBoard BBSs use this one!
  24.  
  25. Battlefield can be played in ANSI color or monochrome, however, play interface
  26. is best using a color display.
  27.  
  28. SYSTEM OPTIONS
  29. ~~~~~~~~~~~~~~
  30. Battlefield supports the use of FOSSIL drivers and non-standard port
  31. addresses.  Refer to the INSTALLATION instructions for more information.
  32.  
  33. FILES CONTAINED IN BATTLE14.ZIP
  34. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  35.      BATTLE14.EXE  <-- The main program
  36.      BATTLE.DOC    <-- The file you are reading!
  37.      GAME.CFG      <-- The game configuration file
  38.      RESET.EXE     <-- Manual game reset program
  39.      REVISION.DOC  <-- Revision notes
  40.      DOORWARE.DOC  <-- Gamekeeper Doorware
  41.  
  42. FILES CREATED BY RESET.EXE
  43. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  44.      PLAYER1.DAT   <-- Player 1 game data **
  45.      PLAYER2.DAT   <-- Player 2 game data **
  46.      FIELD1.DAT    <-- Player 1 playing field data **
  47.      FIELD2.DAT    <-- Player 2 playing field data **
  48.      LASTUSER.DAT  <-- Indicates last player to play **
  49.      RESULTS.DAT   <-- Bulletin file for game results [REGISTERED VERSION]
  50.  
  51. ** These files must be present before the door is run (see INSTALLATION).
  52.  
  53. OVERVIEW
  54. ~~~~~~~~
  55. Battlefield is a two-player game where the object of the game is to capture
  56. the opponent's hidden flag.  You begin by setting up your playing pieces on
  57. the display grid.  Player 1 is red and begins at the top of the grid.  Player
  58. 2 is light blue and begins at the bottom of the grid.  Pieces are placed
  59. anywhere within the first 4 rows on the grid.  Flags should be placed where
  60. they can be well protected (by bombs and high value pieces).  Player 1 begins
  61. the game.  Each player is allowed to move 3 pieces per turn but no piece can
  62. be moved more than once!  The lakes in the center of the grid are off-limits
  63. to both players.  The game keeps track of captured pieces for both players
  64. during each turn.  Most attacks are settled based on the value of each piece
  65. i.e. the player with the highest value (lowest number) wins.  To attack the
  66. enemy, players attempt to move one of their pieces to a space occupied by an
  67. enemy piece.  The game will determine the outcome.  Pieces cannot be moved
  68. diagonally and they cannot jump over other pieces.  Bombs and the flag, once
  69. placed, cannot be moved.
  70.  
  71. Battlefield provides screen redraw capabilities from the player setup and game
  72. play screens.  This feature is commonly used to regenerate the display if
  73. telephone line noise causes erroneous characters to appear.
  74.  
  75. PIECE          VALUE  MOVEMENT          COMMENTS
  76. ~~~~~          ~~~~~  ~~~~~~~~          ~~~~~~~~
  77. KING.............1....1 SPACE...........WATCH OUT FOR THE ENEMY ROGUE!
  78. KING'S AID.......2....1 SPACE...........NONE
  79. WAR MONGER.......3....1 SPACE...........NONE
  80. FIELD LEADER.....4....1 SPACE...........NONE
  81. SWORDSMAN........5....1 SPACE...........NONE
  82. CANNON KEEPER....6....1 SPACE...........NONE
  83. GUARDSMAN........7....1 SPACE...........NONE
  84. POWDERMAN........8....1 SPACE...........CAN DISARM BOMBS!
  85. MEDIC............9....MULTIPLE SPACES...SACRIFICE TO I.D. DISTANT PIECES!
  86. ROGUE............R....1 SPACE...........CAN KILL A KING!
  87. BOMBS............B....NONE..............NONE
  88. FLAG.............F....NONE..............NONE
  89.  
  90. Once a player wins, Battlefield automatically resets its data files for a new
  91. game.  If the SysOp desires to manually reset the game at anytime, he/she can
  92. run RESET.EXE to reset all data files.
  93.  
  94. INSTALLATION
  95. ~~~~~~~~~~~~
  96. Battlefield is easy to install.  Simply follow these steps:
  97.  
  98. 1.  'Unzip' the file BATTLE14.ZIP into the directory of your choice.  All
  99. files must remain in the same directory.
  100.  
  101. 2.  Run RESET.EXE (type RESET and press ENTER) from the Battlefield directory.
  102. Data files will be created for use by the door.
  103.  
  104. 3.  Edit the GAME.CFG configuration file according to the CONFIGURATION FILE
  105. section of these instructions using your favorite word processor.  Ensure you
  106. save it as an ASCII text file.
  107.  
  108. 4.  Create or edit the batch file your BBS will use to activate the door.
  109. The main door program name is BATTLE14.EXE.  For example, if you are running
  110. a Spitfire BBS, you would edit SF.BAT to look similar to the following:
  111.  
  112. :DOOR_A
  113.    REM Place Door A Commands Here
  114.    CD\SF\DOORS\BATTLE   <-- Change to the Battlefield directory
  115.    BATTLE14 GAME.CFG    <-- The main program with configuration file argument
  116.    CD\SF                <-- Change back to the Spitfire directory
  117.    GOTO LOOP
  118.  
  119. NON-STANDARD PORT USE:  You may specify the use of non-standard communications
  120. ports with the PORT command.  The syntax for the PORT command is PORT:03E8:5,
  121. where 03E8 represents a different base address and 5 indicates the IRQ.  For
  122. example, the main program line in the example above would be changed to
  123. BATTLE14 GAME.CFG PORT:03E8:5 to reflect the use of a non-standard comm port.
  124.  
  125. FOSSIL DRIVER USE:  You may specify the use of a FOSSIL driver with the PORT
  126. command added to the main program command line.  The syntax for the PORT
  127. command is PORT:F:P, where F instructs the door to use a FOSSIL driver and P
  128. identifies the port.  For example, the main program line in the example above
  129. would be changed to BATTLE14 GAME.CFG PORT:F:1 if the SysOp wished to specify
  130. a FOSSIL driver on port 1.
  131.  
  132. NOTE:  The PORT command must be the third command in the main program command
  133. line, if used.  If not used, the door defaults to the use of the 4 standard
  134. communications ports (1-4) by reading the BBS file.
  135.  
  136. CONFIGURATION FILE
  137. ~~~~~~~~~~~~~~~~~~
  138. Entries in the GAME.CFG file must be accurate or the door cannot be expected
  139. to function properly.  Save your changes to the GAME.CFG file in ASCII text
  140. format.
  141.  
  142. The GAME.CFG file
  143. ~~~~~~~~~~~~~~~~~
  144. Battlefield                 <-- Line 1  (See below)
  145. c:\sf\door.sys              <-- Line 2    "     "
  146. The Gamekeeper's Lair       <-- Line 3    "     "
  147. Steve Sharpe                <-- Line 4    "     "
  148. 000000000000                <-- Line 5    "     "
  149. 1                           <-- Line 6    "     "
  150.  
  151. Line 1 - This line reflects the name of the door.  The registration algorithm
  152. is based on some of this data.  DO NOT CHANGE LINE 1!
  153.  
  154. Line 2 - Enter the full path and filename for the BBS DOOR.SYS file.
  155.  
  156. Line 3 - Enter the name of your BBS.
  157.  
  158. Line 4 - Enter the SysOp's name.
  159.  
  160. Line 5 - Enter 12 zeros if the door is not registered.  Registered users enter
  161. the registration number provided by the author.  Other numbers will prevent
  162. the door from running.
  163.  
  164. Line 6 - Enter 1 if your BBS DOOR.SYS drop file is the original GAP standard
  165. 31 line version.  Enter 2 if your BBS DOOR.SYS drop file is the newer (longer)
  166. version (presently 52 lines).
  167.  
  168. SYSOP KEYS
  169. ~~~~~~~~~~
  170. The following keys assist the SysOp in the management of the door:
  171.  
  172.          F5 - Shell to DOS
  173.          F8 - Return user to system
  174.          F9 - Toggle display on/off
  175.         F10 - Chat mode (ESC to exit)
  176.       ALT H - Toggle between status lines
  177.  
  178. [REGISTERED VERSIONS]
  179. Registered users are supplied with a file named DATE_CK.EXE which can be used
  180. in a BBS event to automatically reset Battlefield after a variable period of
  181. time.  This feature is particularly useful when two players have begun a game
  182. but one or the other decides not to play any longer (or forgets they are
  183. involved in the game!).  DATE_CK.EXE will read a file named LASTUSED.FIL to
  184. determine whether a reset should be performed.  If necessary, the reset will
  185. be accomplished from the event, without any involvement on the part of the
  186. SysOp.  Registered users who wish to use this feature need to create
  187. LASTUSED.FIL in ASCII text format.  The file should contain 3 lines:
  188. L                 <-- L (locked)
  189. 7                 <-- Reset 7 days from date below if no activity *
  190. 9/3/1992          <-- Date of last play action (no leading zeros please)
  191.  
  192. * Use a number from 1 to 30 in line 2
  193.  
  194. Place the file in the Battlefield directory and forget it!  The door will read
  195. and update it as necessary so the event program (DATE_CK.EXE) can monitor
  196. game activity.  The file is not read in unregistered versions.
  197.  
  198. REGISTRATION
  199. ~~~~~~~~~~~~
  200. The registration fee for Battlefield is $10.  The unregistered door displays
  201. "EVALUATION COPY" upon entry and exit.  Please register or remove the door
  202. within 90 days of first use.  As a BBS SysOp, I understand how costly it can
  203. be to register BBS software.  I have purposely kept the cost of registering
  204. Battlefield to a minimum with that thought in mind.  I believe the fee is
  205. quite reasonable, based on the many long hours of programming required.  Upon
  206. receipt of the registration fee, you will be provided with a unique
  207. registration number.  Once you insert the registration number into the GAME.CFG
  208. file, the opening and closing "EVALUATION COPY" messages will be replaced with
  209. the following messages:
  210.  
  211. [OPENING MESSAGE]
  212.  
  213.                                 Your BBS name
  214.  
  215.                                   presents
  216.  
  217. [CLOSING MESSAGE]
  218.  
  219.                              Thanks for playing
  220.  
  221.                                 Battlefield
  222.  
  223.                                      on
  224.  
  225.                                Your BBS name
  226.  
  227. Once the door is registered, the RESULTS.DAT file will post the results of
  228. completed games for use in your BBS bulletin area.
  229.  
  230. COMMENTS/BUG REPORTS
  231. ~~~~~~~~~~~~~~~~~~~~
  232. I'm interested in all user comments and bug reports.  Please send your comments
  233. to:
  234.  
  235. Steve Sharpe                              Call The Gamekeeper's Lair BBS
  236. 1835 Stonetree Dr.              or        (208) 587-1105
  237. Mountain Home, ID 83647                   and leave a message
  238.  
  239.                                  Warranty
  240.                                ------------
  241.        This program has been thoroughly tested on a Spitfire 3.2 BBS,
  242.        however, it should perform equally well on any BBS that can
  243.        produce a BBS drop file listed in this documentation.
  244.  
  245.        I make no warranty of any kind, express or implied, including
  246.        without limitation, any warranties of merchantability and/or
  247.        fitness for a particular purpose.  I shall not be held liable for
  248.        any  damages, whether direct, indirect, special or consequential
  249.        arising from a failure  of this program to operate in the manner
  250.        desired by the user.  I shall not be held liable for any damage to
  251.        data or property which may be caused directly or indirectly by the
  252.        use of this program.
  253.  
  254.        In no event will I be held liable for any damages, including (but
  255.        not limited to) any lost profits, lost savings or other incidental
  256.        or consequential damages arising out of the use or inability to
  257.        use this program, or for any claim by any other party.
  258.  
  259.        This warranty is governed by the laws of the State of Idaho.
  260.                               REGISTRATION FORM
  261.                               -----------------
  262.  
  263.   Battlefield                      Return to:  Steve Sharpe
  264.   Version 1.4                                  Attn: Door Registration
  265.   Registration Cost: $10                       1835 Stonetree Dr.
  266.                                                Mountain Home, ID 83647
  267.  
  268.   Name ______________________________________________________________
  269.  
  270.   Address ___________________________________________________________
  271.  
  272.           ___________________________________________________________
  273.  
  274.   Voice Phone _____________________ Data Phone ______________________
  275.  
  276.   Enter GAME.CFG file information below:
  277.  
  278.   BBS Name______________________________________________
  279.  
  280.   SysOp Name____________________________________________
  281.  
  282.   CHOOSE ONE OPTION BELOW:
  283.  
  284.   ____  I wish to download my registration number from The Gamekeeper's Lair
  285.         BBS at (208) 587-1105.  Enter the password you will use to log on to
  286.         The Gamekeeper's Lair BBS: _________________________________________
  287.         Enter your birthdate for pre-verification: _________________________
  288.         Please allow enough time for your registration fee to reach the author
  289.         before calling for your registration number.
  290.  
  291.   ____  I wish to have my registration number mailed to the address listed
  292.         above.
  293.  
  294.   Orders outside the USA add $2.00 . . . . . . . . . . . . _________
  295.  
  296.       Please find enclosed a check or money order for USA $_________
  297.   payable to Steve Sharpe.  This shows my support of Shareware products
  298.   and the Shareware concept.  It also shows my encouragement to help further
  299.   the development of BBS doors.
  300.  
  301.       I understand that Battlefield is provided as-is and no warranties of
  302.   any kind, expressed or otherwise, are included and that I am using it at my
  303.   own risk.
  304.  
  305.   Signed: _________________________________________  Date: _________
  306.